home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / asmutil / asm_n_z.zip / SD2.DOC < prev    next >
Text File  |  1987-05-15  |  4KB  |  97 lines
  1.  
  2.  
  3. Introduction
  4.  
  5.      Switch Directory (SD) is a utility that allows you to easily switch
  6.      between subdirectories and drives with a minimum of typing.  All you
  7.      need to do is type SD and the name of the drive/subdirectory you desire
  8.      to go to and SD takes you there.  If you have made a mistake, hitting
  9.      Ctrl-Brk will break you out of the program and put you back in the
  10.      subdirectory you started in.
  11.  
  12. Usage
  13.  
  14.  
  15.       [d:\....]>SD [drive][switch][subdirectory name]
  16.  
  17.                       Options:
  18.  
  19.                            [drive] - the drive to search
  20.  
  21.                            [switch] = blank - search whole disk
  22.  
  23.                                     = \ - search only subdirectories of the
  24.                                           current directory
  25.  
  26.                                     = / - search only one path deep. (Similar
  27.                                           to DOS CD command with one pathname)
  28.  
  29.  
  30.  
  31.                            [subdirectory name] - the name of an individual
  32.                                                  subdirectory (not the
  33.                                                  complete path)
  34.  
  35.                            ? - shows help screen
  36.  
  37.                            If the command line is left blank then you are
  38.                            taken to the root directory of the disk
  39.  
  40. Examples
  41.  
  42.       SD d:             - changes the active drive to d: and puts you
  43.                           in the root directory
  44.  
  45.       SD /source        - searches the root directory of the current drive
  46.                           for a subdirectory named source and puts you in
  47.                           in it
  48.  
  49.       SD \source        - searches the current directory for subdirectories
  50.                           named source and puts you in the first one it finds
  51.  
  52.       SD source         - searches the current drive for a subdirectory named
  53.                           source and puts you in the first one it finds
  54.  
  55.       SD d:source       - changes the current drive to d and searches that
  56.                           drive for a subdirectory named source and puts you
  57.                           in the first one it finds.
  58.  
  59. Caveats and Other Things
  60.  
  61.      Caveats first.  If you have duplicate subdirectory names SD will
  62.      drop you in the first one it finds.  SD will only search the drive
  63.      that is specified.  If you have a large number of subdirectories with
  64.      a lot of depth SD could take a few seconds to find its way; be patient,
  65.      such is the price of progress.  Of course, with the source code
  66.      included, you could try and improve the search and speed it up.  Any
  67.      improvements to the code would be welcomed.  The source was derived
  68.      from Vern Buerg's sorted directory program, LDIR and WHISK by Charles
  69.      Wooster.  Thanks guys.  It is written for the A86 assembler.
  70.      This shouldn't be a problem for anyone who is using MASM.
  71.  
  72.      If you have any comments, suggestions or bug reports drop me
  73.      a line on Bob Blacher's Computer Connection in DC.
  74.  
  75.                                                     Stephen Falatko
  76.  
  77.  
  78.  
  79. Update Notes
  80.  
  81.      Version 1 - 3/12/87
  82.  
  83.      Version 1.1 - 3/18/87  Bug fix.  An error in the routine that creates
  84.                             a full path name for use in actually setting
  85.                             path would preclude switching to directories
  86.                             whose depth was greater than 2 deep.
  87.  
  88.      Version 2.0 - 5/15/87  Changed the path search routine.  Added new
  89.                             features, the / and \ switches to search one path
  90.                             deep and search only subdirectories of the current
  91.                             directory respectively.  This provides a means to
  92.                             refine the searching and provide more speed.  You
  93.                             can now search other drives by specifying a drive
  94.                             on the command line.  Added break out feature so
  95.                             that hitting Ctrl-Brk will place you in your
  96.                             original directory.
  97.